home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / drlistj.zip / DRLIST.DOC < prev    next >
Text File  |  1989-09-07  |  24KB  |  576 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         DRLIST Version J
  7.  
  8.                 (c) Copyright Vernon D. Buerg 1986-89
  9.  
  10.  
  11.  
  12.                      Special BBS/CTTY Version
  13.                      ________________________
  14.  
  15.  
  16.                            Sept 17, 1989
  17.  
  18.  
  19.  
  20.  
  21.                         Table of Contents
  22.                         -----------------
  23.  
  24.                 Description ......................  1
  25.                 Display format ...................  2
  26.                  Status line .....................  2
  27.                  Command line ....................  3
  28.                 Keys and commands ................  4
  29.                  Positioning to lines ............  5
  30.                 Cloning procedure ................  6
  31.                  DEBUG Information ...............  7
  32.                  Screen attributes ...............  8
  33.                 Searching for text................  9
  34.                 Filtering ........................ 10
  35.                 Update history ................... 11
  36.                 Special version remarks .......... 12
  37.                 Restrictions ..................... 13
  38.  
  39.                                                       DRLIST     Page 1
  40.  
  41.  Command  DRLIST
  42.  -------------
  43.  
  44.  Purpose:  To display the contents of an ASCII text file,  line by  line
  45.         with the aid of scrolling, positioning and filtering commands.
  46.  
  47.  Format:   DRLIST  [d:][path]filename[.ext]
  48.  
  49.  Remarks:  An ASCII file of any size may be listed.
  50.  
  51.            The "filename" is optional.  If omitted, you are prompted  to
  52.         to enter  a filename.   You may  include drive,  path, and  wild
  53.         cards in the file name.   The first file which matches  the name
  54.         is displayed until an end-of-file character is encountered. Each
  55.         file which matches the "filename" may be displayed.
  56.  
  57.            DRLIST was  designed to display ASCII files.  That  is, files
  58.         which  contain  text  and  not  binary  or  control codes.  Text
  59.         characters  usually  range  from a  value of 32 to 127.  To view
  60.         binary files (COM, EXE, etc), the D-key hex dump display  option
  61.         is available.
  62.  
  63.            Characters  below  32  (a  blank)  are  replaced with a funny
  64.         character to indicate that a non-displayable character has  been
  65.         encountered.  This character is an upside-down question mark.
  66.  
  67.            Characters above 127 may be valid graphic characters, and may
  68.         be displayed if  the '8' command  is in effect.   To insure that
  69.         characters above ASCII value 127 are not displayed, use the  '7'
  70.         command.
  71.  
  72.            The top line of the display gives the file name, current right
  73.         scroll offset, and the file's creation date and time. Optionally,
  74.         a ruler may be displayed on the top line by using the R key.
  75.  
  76.            The  file  is  displayed  with  one  logical  record  on each
  77.         80-column display line.   A logical record  ends in a  linefeed.
  78.         The maximum logical record may  be 256 characters long.  If  the
  79.         record exceeds 80  characters, you may  view the portion  beyond
  80.         the 80 columns  by using the  scroll right command,  or by using
  81.         the Wrap feature.
  82.  
  83.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  84.         longer than 80 characters.  With Wrap on, lines are displayed in
  85.         their  entirety,  80  characters  per  display line.  The scroll
  86.         -left and -right functions are disabled when Wrap is ON.
  87.  
  88.            The file may  be PRINTed as  it it displayed.   The P command
  89.         toggles  the  printer  on  or  off.   When  first entered, the P
  90.         command causes the current screen  to be printed.  As new  lines
  91.         are displayed, they too are printed.  Printing may be stopped by
  92.         entering another P command.  The PrtSc key may also be used, but
  93.         the title and prompt lines will be printed with the lines of the
  94.         file. Empty lines cause a line to be skipped on the printer. The
  95.         letter P is displayed in column 80 of the top line while printing.
  96.                                                       DRLIST     Page 2
  97.  
  98.  Display format
  99.  --------------
  100.  
  101.            The monitor display is defined in terms of lines and columns.
  102.         A typical monitor can display 25 lines of 80 columns each. DRLIST
  103.         attempts to use the number of lines and columns for the monitor
  104.         mode in use.  For example, if the monitor is in 40 column mode,
  105.         DRLIST displays only 40 characters per line.
  106.  
  107.            The top line of the display is called the Status line.  The
  108.         bottom line is called the Command line.  The remaining lines are
  109.         called the primary display window, and are usually lines 2
  110.         through 23.
  111.  
  112.  
  113.  Status line format
  114.  ------------------
  115.  
  116.     The Status line has the following format:
  117.  
  118.     DRLIST   lllll +sss mm/dd/yy hh:mm  bKMPSW  - filename
  119.  
  120.     where,
  121.  
  122.         'DRLIST'     is the name of this program
  123.  
  124.         'lllllll'  is the line number of the first line in the
  125.                   display window (usually on line 2)
  126.  
  127.         '+sss'     if displayed, this is the Scroll amount, in
  128.                   multiples of 20, corresponding to the number
  129.                   of columns that the display has been shifted
  130.                   to the right to view records longer than 80
  131.  
  132.         'mm/dd/yy' is the file's creation date
  133.         'hh:mm'    is the file's creation time
  134.  
  135.         'D'       indicates that the hex Dump display option is in use
  136.         'b'       indicates whether the 7-bit, 8-bit, or *-option is
  137.                   in use
  138.         'K'       indicates that the Keyboard flush option is in use
  139.         'M'       indicates that tests for monitor retrace are not made
  140.         'P'       indicates that Print is in use
  141.         'S'       indicates that the C (file sharing) is in use
  142.         'W'       indicates that the Wrap mode is in effect
  143.                                                       DRLIST     Page 3
  144.  
  145.  Command line format
  146.  -------------------
  147.  
  148.     The Command line has the following format:
  149.  
  150.     command message ______ Keys: Num-keypad Q=next X=exit ?=Help
  151.  
  152.     where,
  153.  
  154.       'command' indicates the current process:
  155.  
  156.           'Command'   you are being asked to enter a command
  157.                        enter the letter, or press the keys for
  158.                        the action to perform
  159.  
  160.           'Reading '   the file data is being read
  161.           'Filter  '   the file data is being formatted for display
  162.           'Scanning'   the Scan/Find text is being searched for
  163.  
  164.           'Scan   '   you are being asked to enter text to locate
  165.           'Find   '    in the file, up to 31 characters may be entered
  166.  
  167.           '# lines?'   you are being asked to enter a 1 to 5 digit
  168.                        number that is the amount of lines to skip
  169.  
  170.           'Line #? '   you are being asked to enter a 1 to 5 digit
  171.                        line number to which the display is to be
  172.                        positioned
  173.  
  174.  
  175.       'message' may be one of:
  176.  
  177.           '*** Text not found ***'
  178.            the Scan/Text was not found in the file
  179.  
  180.           '   *** Top of file ***'
  181.            the first line of the file is being displayed
  182.  
  183.           '   *** End-of-file ***'
  184.            the last line of the file is being displayed
  185.                                                       DRLIST     Page 4
  186.  
  187.  Key functions and Commands
  188.  --------------------------
  189.  
  190.         On the COMMAND line, enter a letter or control key:
  191.  
  192.         Letter(s)     Default   Function
  193.         ---------     -------   ------------------------
  194.         A                       find next occurance of 'text'
  195.         B                       skip to end of file (bottom)
  196.         C               off     toggles closing of (shared) files
  197.         D                       toggles hex dump display mode
  198.         E               on      set hi-bit on, Eight-bit mode
  199.         F                       Find 'text' regardless of case
  200.         H or ?                  list commands (HELP)
  201.